home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / comm / misc / StreAmi.readme < prev   
Text File  |  2001-01-02  |  4KB  |  115 lines
  1. Short:    Shoutcast/Icecast Amiga client (v1.24)
  2. Author:   Sebastian Jedruszkiewicz
  3. Uploader: Sebastian Jedruszkiewicz <elf@frogger.rules.pl> 
  4. Type:     comm/misc
  5. Requires: mpega.library, TCP stack. NList.mcc
  6.  
  7. What is it?
  8. -----------
  9. StreAmi is an Amiga client for very popular audio streaming
  10. over the net. There are two well known streaming systems,
  11. Icecast and Shoutcast, which can send audio data over network
  12. compressed with mpg audio. StreAmi allows you to connect to
  13. such a server and listen to the audio in realtime.
  14.  
  15. What you need?
  16. --------------
  17.     - mpega.library
  18.      - TCP stack (Miami, AmiTCP)
  19.      - fast internet connection.
  20.     - about 300kb of free memory.
  21.     - NList MUI class
  22.  
  23. How to use:
  24. -----------
  25.     StreAmi comes with MUI GUI interface. After starting
  26. you should change prefs files to anything you want.
  27. I wont explain here what all thse gadgets means. It should be quite
  28. clear. anyway:
  29.     - Audio buffer size, describes how many audio is send to
  30.        ahi each time.
  31.      - Net buffer size, describes how many data is fetched from network
  32.        (data is fetched in asynchronous way).
  33. If you do not understand what something means - do not touch it.
  34. If you know what everything means - write me a nice guide, I do
  35. not have much free time left for that ;).
  36.  
  37. Now, you have your prefs set. from pulldown menu select "Server List"
  38. Add any serwer you want. You can find list of servers on
  39. http://www.shoutcast.com or http://www.icecast.org
  40. In this archive I have included simple list with 3 servers.
  41.  
  42. Ok, now select you preffered server in main window, and click connect.
  43. enjoy.
  44.  
  45. NOTE: Prefs and server list is stored in progdir: in text file.
  46. Do not mess with it unless you know exactly what are you doing.
  47. You have been warned.
  48.  
  49. Suggestions:
  50. ------------
  51. Send anything to streami@frogger.rules.pl
  52.  
  53.  
  54. Bugs, Not finished features, future:
  55. ------------------------------------
  56.     - Changing prefs on fly does not work. Only audio buffer size
  57.       and net io size is updated.
  58.     - Support for #?.pls files should be added.
  59.     - CLI options whould be a nice idea too.
  60.     - With slow connections sometimes audio goes crazy.
  61.       Dunno why.
  62.     - Maybe I will also create server, for sending audio streams
  63.       to the net.
  64.     - some of the errors are still displayed in CLI.
  65.  
  66. Authors:
  67. --------
  68.     Programming: Sebastian Jedruszkiewicz
  69.     StreAmi logo: Grzegorz Kraszewski
  70.  
  71.  
  72. Changes:
  73. --------
  74. 1.1
  75.      - fixed problems with deadlocks if connection failed.
  76.      - no more deadlocks if connection is lost.
  77.  
  78. 1.2
  79.      - fixed bug in ahi code causing crash.
  80.  
  81. 1.21
  82.      - Fixed bug in Server List gui.
  83.  
  84. 1.22
  85.      - Fixed bug which caused deadlock, when server sends error
  86.        response on StreAmi request. 
  87.      - AHI Unit was not read from .prefs file. fixed.
  88.  
  89. 1.24
  90.      - some changes in network code, should be faster, and much more stable now.
  91.      - added support for #?.pls files, please go to http://frogger.rules.pl/streami
  92.        for instructions how to setup you favorite browser to use #?.pls files with
  93.        StreAmi.
  94.      - started adding CLI interface, right now only PLSFILE works.
  95.      - Tasks created by streami now have bumped priority, to prevent audio from 
  96.        stoping.
  97.      - audio buffer size was NOT used! I dont know how it happened, but now it is,
  98.        and bigger audio blocks should be send to ahi.device, thus audio wont be
  99.        interrupted, by for example moving windows.
  100.  
  101.  
  102. ============================= Archive contents =============================
  103.  
  104. Original  Packed Ratio    Date     Time    Name
  105. -------- ------- ----- --------- --------  -------------
  106.      138     120 13.0% 08-Dec-00 18:34:28  .prefs
  107.      281     188 33.0% 23-Dec-00 00:37:48  .servers
  108.    44172   23993 45.6% 23-Dec-00 00:37:52  StreAmi
  109.     5248    3848 26.6% 11-Nov-80 11:20:30  StreAmi.info
  110.     3404    1612 52.6% 08-Dec-00 17:58:58  StreAmi.readme
  111.    12606    4248 66.3% 16-Oct-00 00:37:24  StreAmi_eng.guide
  112.    13813    4857 64.8% 16-Oct-00 00:37:24  StreAmi_ger.guide
  113. -------- ------- ----- --------- --------
  114.    79662   38866 51.2% 25-Dec-100 20:49:02   7 files
  115.